home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / util / arc / xadmaster.lha / xad / Docs / xadUnFile.doc < prev    next >
Text File  |  2000-04-02  |  7KB  |  187 lines
  1. NAME
  2.     xadUnFile 1.17
  3.     xadUnFileM 1.17
  4.  
  5. SYNOPSIS
  6.     xadUnFile FROM/A,DEST=DESTDIR,PASSWORD/K,FILE/M,NAMESIZE/K/N,
  7.     FFS=OFS/S,SFS/S,INFO=LIST/S,Q=QUIET/S,AM=ASKMAKEDIR/S,OW=OVERWRITE/S,
  8.     SP=SHOWPROT/S,VERBOSE/S,DARC=DISKARCHIVE/S,ENTRY/K/N,DIMG=DISKIMAGE/S,
  9.     NA=NOABS/S,NC=NOCOMMENT/S,ND=NODATE/S,NE=NOEXTERN/S,NKP=NOKILLPART/S,
  10.     NP=NOPROT/S,NT=NOTREE/S
  11.  
  12.     xadUnFileM FROM/A/M,DEST=DESTDIR/K,PASSWORD/K,FILE/K,NAMESIZE/K/N,
  13.     FFS=OFS/S,SFS/S,INFO=LIST/S,Q=QUIET/S,AM=ASKMAKEDIR/S,OW=OVERWRITE/S,
  14.     SP=SHOWPROT/S,VERBOSE/S,DARC=DISKARCHIVE/S,ENTRY/K/N,DIMG=DISKIMAGE/S,
  15.     NA=NOABS/S,NC=NOCOMMENT/S,ND=NODATE/S,NE=NOEXTERN/S,NKP=NOKILLPART/S,
  16.     NP=NOPROT/S,NT=NOTREE/S
  17.  
  18. DESCRIPTION
  19.     xadUnFile is the master shell tool to extract data from
  20.     file archives.
  21.  
  22.     FROM specifies the file archive that should be handled.
  23.     The xadUnFileM tool can handle splitted archives, when they are
  24.     given in their correct order. Do not give multiple names of
  25.     single archives! You may use patterns with xadUnFileM.
  26.  
  27.     DESTDIR is the destination directory. The directory is created
  28.     when it does not exist (except if ASKMAKEDIR is turned on and
  29.     you select no). There are some dangerous archives using absolute
  30.     path names (e.g. starting with LIBS: or RAM:). xadUnFile archives
  31.     these files to their absolute position (except NOTREE or NOABS is
  32.     used). For xadUnFileM this argument requires the keyword DEST or
  33.     DESTDIR.
  34.  
  35.     PASSWORD can be used to supply a password for unarchiving of
  36.     encrypted archives. This argument requires the keyword PASSWORD.
  37.  
  38.     FILE allows you to select filename(s) (including patterns), which
  39.     should be extracted. When FILE is not given, all files are
  40.     extracted. With FILE only matching files are extracted.
  41.     NOTE: When you do not use NOTREE keyword, the patterns check
  42.     includes checks for directory structure as well.
  43.     For xadUnFileM there are some special rules:
  44.       To pass multiple names, use patterns like (xxx|yyy|zzz), where
  45.       xxx, yyy and zzz are three file names. You cannot pass multiple
  46.       strings like for xadUnFile. And additionally this argument
  47.       requires the keyword FILE.
  48.  
  49.     NAMESIZE allows to specify the maximum size of a filename. This is
  50.     useful as some archives from unix machines have longer filenames
  51.     than the Amiga filesystem allows. Whenever a name is longer than
  52.     the namesize value, you are asked to enter a shorter name. Names
  53.     of directories are truncated without requests.
  54.     FFS or OFS replace NAMESIZE argument and provide a standard length
  55.     of 30 characters, which is the value of our standard file system.
  56.     SFS provide a length of 100 characters, the SmartFilesystem
  57.     standard.
  58.  
  59.     NOEXTERN prohibits the use of external clients for
  60.     recognition purposes.
  61.     
  62.     INFO or LIST prints information about the archive and does not
  63.     do any unarchiving. SHOWPROT turns on display of protection
  64.     information. VERBOSE shows additional information texts, which
  65.     exist for some archivers.
  66.     
  67.     OVERWRITE forces the program to overwrite an already existing
  68.     destination file. Normally you are asked about that.
  69.     
  70.     NOTREE skips all directory names and writes the files directly to
  71.     destination directory.
  72.     
  73.     ASKMAKEDIR forces the program to ask you, if a missing directory
  74.     should be created.
  75.     
  76.     NOCOMMENT prevents setting archived file comments, NOPROT prevents
  77.     setting file protection bits and NODATE prevents setting date
  78.     information. NOCOMMENT also prevents displaying comment lines with
  79.     INFO or LIST keyword.
  80.     
  81.     NOABS prevents creation of absolute path names.
  82.  
  83.     If you specify NOKILLPART keyword, partial or corrupt output files
  84.     no longer are deleted.
  85.  
  86.     The QUIET option turns off the progress report, but also disables
  87.     questions to skip, rename or overwrite files.
  88.  
  89.     The tool allows to extract files from disk images. If you specify
  90.     DISKIMAGE, the input file is handled as disk image (ADF file)
  91.     and not as file archive. If it is an valid Amiga filesytem disk,
  92.     files can be extracted from it. Specifying DISKARCHIVE is like
  93.     DISKIMAGE, but input data is an disk archive, which is dearchived
  94.     before extracting files. If the disk archive has multiple entries,
  95.     you may use ENTRY keyword to specify the wanted entry.
  96.  
  97. EXAMPLES
  98.     Shell> xadUnFile archive.tar RAM:
  99.         Unarchive the tar archive to RAM:
  100.  
  101.     Shell> xadUnFile archive.lha RAM: #?.txt #?.doc Contents
  102.         Unarchive all .txt and .doc file and the file "Contents" of
  103.         lha archive to RAM:
  104.  
  105.     Shell> xadUnFile archive.lha DEST RAM: FILE (#?.txt|#?.doc|Contents)
  106.         The same call for xadUnFileM
  107.  
  108.     Shell> xadUnFile archive.lha LIST
  109.         Tells information about archive.lha file.
  110.  
  111.     Shell> xadUnFile image.adf DIMG LIST
  112.         Tells information about files in disk image image.adf.
  113.  
  114.     Shell> xadUnFileM archive.lha archive.l[0-9]? LIST
  115.         Tells information about splitted lha archive.
  116.  
  117. HISTORY
  118.     xadUnFile 1.17, xadUnFileM 1.17
  119.     - added support for archives with unknown decrunched size
  120.  
  121.     xadUnFile 1.16, xadUnFileM 1.16
  122.     - bug fixes
  123.  
  124.     xadUnFile 1.15, xadUnFileM 1.15
  125.     - added support for patterns in xadUnFileM
  126.  
  127.     xadUnFile 1.14, xadUnFileM 1.14
  128.     - added DISKARCHIVE, DISKIMAGE and ENTRY parameters
  129.     - bug fixes
  130.  
  131.     xadUnFile 1.13, xadUnFileM 1.13
  132.     - added VERBOSE parameter
  133.  
  134.     xadUnFile 1.12, xadUnFileM 1.12
  135.     - added NOKILLPART parameter
  136.  
  137.     xadUnFile 1.11, xadUnFileM 1.11
  138.     - added SFS parameter
  139.  
  140.     xadUnFile 1.10, xadUnFileM 1.10
  141.     - added NAMESIZE and FFS or OFS parameters
  142.  
  143.     xadUnFile 1.9, xadUnFileM 1.9
  144.     - Now also sets protection bits and comment for directories. The
  145.       date is correct for empty dirs only, as the OS automatically
  146.       updates the date, if something is changed in the directory.
  147.  
  148.     xadUnFile 1.8, xadUnFileM 1.8
  149.     - Also strips "/" or ":" at name start for NOABS option.
  150.  
  151.     xadUnFile 1.7, xadUnFileM 1.7
  152.     - new options SHOWPROT and QUIET
  153.     - normal xadUnFile got back style of 1.4 and the multifile archive
  154.       style has been implemented in the special xadUnFileM tool.
  155.       Splitted archives are very seldom and it is of no use to make the
  156.       shell arguments that complicated for single file archives.
  157.  
  158.     xadUnFile 1.6
  159.     - added multiple input file support and renaming
  160.  
  161.     xadUnFile 1.4
  162.     - no longer aborts when unarchiving failed for one entry
  163.     - added NOABS option and comment display with INFO
  164.  
  165.     xadUnFile 1.3
  166.     - added size output for "group archivers" like LzX
  167.  
  168.     xadUnFile 1.2
  169.     - added output for corrupted files
  170.  
  171.     xadUnFile 1.1
  172.     - added FILE parameter and directory creation
  173.  
  174.     xadUnFile 1.0
  175.     - First public release.
  176.  
  177. COPYRIGHT
  178.     xadUnFile is freely distributable for noncommercial use.
  179.  
  180. AUTHOR
  181.     Dirk Stöcker
  182.     Geschwister-Scholl-Straße 10
  183.     01877 Bischofswerda
  184.     GERMANY
  185.     
  186.     Dirk Stoecker <stoecker@amigaworld.com>
  187.